home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / ns.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  61 lines
  1.  
  2. NS(3)                      UNIX Programmer's Manual                      NS(3)
  3.  
  4. NNAAMMEE
  5.      nnss__aaddddrr, nnss__nnttooaa - Xerox NS(tm) address conversion routines
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
  9.      ##iinncclluuddee <<nneettnnss//nnss..hh>>
  10.  
  11.      _s_t_r_u_c_t _n_s___a_d_d_r
  12.      nnss__aaddddrr(_c_h_a_r _*_c_p)
  13.  
  14.      _c_h_a_r _*
  15.      nnss__nnttooaa(_s_t_r_u_c_t _n_s___a_d_d_r _n_s)
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The routine nnss__aaddddrr() interprets character strings representing XNS ad-
  19.      dresses, returning binary information suitable for use in system calls.
  20.      The routine nnss__nnttooaa() takes XNS addresses and returns ASCII strings rep-
  21.      resenting the address in a notation in common use in the Xerox Develop-
  22.      ment Environment:
  23.  
  24.            <network number>.<host number>.<port number>
  25.  
  26.      Trailing zero fields are suppressed, and each number is printed in hex-
  27.      adecimal, in a format suitable for input to nnss__aaddddrr().  Any fields lack-
  28.      ing super-decimal digits will have a trailing `H' appended.
  29.  
  30.      Unfortunately, no universal standard exists for representing XNS address-
  31.      es.  An effort has been made to insure that nnss__aaddddrr() be compatible with
  32.      most formats in common use.  It will first separate an address into 1 to
  33.      3 fields using a single delimiter chosen from period `.', colon `:' or
  34.      pound-sign `#'. Each field is then examined for byte separators (colon or
  35.      period).  If there are byte separators, each subfield separated is taken
  36.      to be a small hexadecimal number, and the entirety is taken as a network-
  37.      byte-ordered quantity to be zero extended in the high-network-order
  38.      bytes.  Next, the field is inspected for hyphens, in which case the field
  39.      is assumed to be a number in decimal notation with hyphens separating the
  40.      millenia.  Next, the field is assumed to be a number: It is interpreted
  41.      as hexadecimal if there is a leading `0x' (as in C), a trailing `H' (as
  42.      in Mesa), or there are any super-decimal digits present.  It is inter-
  43.      preted as octal is there is a leading `0' and there are no super-octal
  44.      digits.  Otherwise, it is converted as a decimal number.
  45.  
  46. RREETTUURRNN VVAALLUUEESS
  47.      None. (See _B_U_G_S.)
  48.  
  49. SSEEEE AALLSSOO
  50.      hosts(5),  networks(5),
  51.  
  52. HHIISSTTOORRYY
  53.      The nnss__aaddddrr() and nnss__ttooaa() functions appeared in 4.3BSD.
  54.  
  55. BBUUGGSS
  56.      The string returned by nnss__nnttooaa() resides in a static memory area.  The
  57.      function nnss__aaddddrr() should diagnose improperly formed input, and there
  58.      should be an unambiguous way to recognize this.
  59.  
  60. 4.3 Berkeley Distribution        June 4, 1993                                1
  61.